home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 005a / wonder10.zip / HISTORY.DOC < prev    next >
Text File  |  1993-03-13  |  61KB  |  1,475 lines
  1.  
  2.  
  3.  
  4.                               W o n d e r W h o
  5.                               -----------------
  6.  
  7.                                 Version 1.00
  8.                           Released March 13th, 1993
  9.  
  10.                   I  Wonder  Who  Transfered  That  File ?
  11.                   Shareware program door for PCBoard v14.x
  12.  
  13.          Copyright (C) 1993 by José De Almeida. All Rights Reserved.
  14.                  P.O.Box 4185. 1504 Lisboa Codex. Portugal.
  15.  
  16.  
  17.  
  18.                            --- VERSION HISTORY ---
  19.  
  20.  
  21.  
  22. ------------------------------------------------------------------------------
  23. WonderWho v1.00:  Mar 13, 1993
  24. ------------------------------------------------------------------------------
  25.  
  26.   ■ This is the first 'true' release. The first non-beta version of WonderWho.
  27.     If you are installing WonderWho for the first time, you don't need to read
  28.     this file. Instead, please refer to the WONDER.DOC Documentation file.
  29.  
  30.   ■ If  you  are updating  from the  previous version  0.19, first  delete the
  31.     following files:
  32.  
  33.         HISTORY.TXT
  34.         LICENSE.DOC
  35.  
  36.    Then, you will need to overwrite or add the following files:
  37.  
  38.         WONDER.EXE
  39.         WONDER.DOC     (documentation file, this is new!)
  40.         WONDER.CFG     (please re-configure, if that is the case)
  41.         WW_LANG        (please re-configure, if that is the case)
  42.         WW_NEWS
  43.         HISTORY.DOC
  44.  
  45.     That's all! But please continue to read this file.
  46.  
  47.   ■ Changed  the message "Waiting  for Call" to  "No Caller this  Node" in the
  48.     [WHO] commands.
  49.  
  50.   ■ Removed the LICENSE.DOC file from  the file. Its contents are now included
  51.     in the Documentation file WONDER.DOC.
  52.  
  53.   ■ Concluded the WonderWho Documentation file WONDER.DOC.
  54.  
  55.     Many many thanks to Mr.Afonso Vicente, SysOp of Intriga Internacional BBS,
  56.     who revised my  english in the Documentation file as  well as this version
  57.     history file.
  58.  
  59. ------------------------------------------------------------------------------
  60. WonderWho v0.19:  Mar 4, 1993
  61. ------------------------------------------------------------------------------
  62.  
  63.   ■ If you are updating from the  previous version 0.18, you will only need to
  64.     overwrite or add the following files:
  65.  
  66.         WONDER.EXE
  67.         WONDER.CFG     (please re-configure, if that is the case)
  68.         HISTORY.TXT
  69.  
  70.     That's all! But please continue to read this file.
  71.  
  72.   ■ Moved from ProKit version 3.4 to ProKit version 3.44.
  73.     WonderWho remains the same.
  74.  
  75.   ■ Added another option to the WONDER.CFG configuration file:
  76.  
  77.         CALLER_LOG=
  78.  
  79.     With this option  you can enable or disable  saving information about each
  80.     command  a  user  entered  while  in  the  WonderWho  door, in the PCBoard
  81.     CALLER's log file.  Unless you un-comment the line  in the WONDER.CFG file
  82.     and specify differently, by default this option enables the written to the
  83.     CALLER's log file, as it happens in the previous versions.
  84.  
  85.     So, if you want WonderWho to written  to the file, don't do anything about
  86.     this in the configuration file.
  87.  
  88.   ■ Corrected bugs of the [WHO] command.
  89.  
  90.     Now WonderWho is compatible with PCBoard's new file USERNET.XXX format and
  91.     also with the older file USERNET.DAT format.
  92.  
  93.     Routines for reading this file where written from scratch.
  94.  
  95.     Many  thanks to  Mr.Mário Pozzetti  (SysOp of  SkyShip BBS)  who helped me
  96.     getting all the necessary informations about this new file format.
  97.  
  98.   ■ This  version  of WonderWho  requires about  191 KBytes  of RAM  to run (8
  99.     KBytes more than previous version).
  100.  
  101.   ■ If  nobody  complains  with  bugs  or  so,  I  will continue to  write the
  102.     WonderWho Documentation,  which I already  started. It's the  last missing
  103.     thing, in order to distribute version 1.0.
  104.  
  105. ------------------------------------------------------------------------------
  106. WonderWho v0.18:  Mar 2, 1993
  107. ------------------------------------------------------------------------------
  108.  
  109.   ■ If  you  are updating  from the  previous version  0.17, first  delete the
  110.     following files:
  111.  
  112.         WONDER_W.*
  113.         WONDER_N.*
  114.         WONDER_M.*
  115.         WONDER_Q.*
  116.         HELP_*.*
  117.  
  118.    Then, you will need to overwrite or add the following files:
  119.  
  120.         WONDER.EXE
  121.         WONDER.CFG    (config file; see bellow)
  122.         WW_LANG       (THIS IS NEW!: language file; see bellow)
  123.         WW_H_*        (all help files have new names }
  124.         WW_WELC       (welcome file have a new name)
  125.         WW_NEWS       (news file have a new name)
  126.         WW_MENU       (menu file have a new name)
  127.         WW_QUIT       (quit file have a new name)
  128.         HISTORY.TXT
  129.  
  130.     That's all! But please continue to read this file.
  131.  
  132.   ■ As  you probably notice,  all Help files  have different names.  Also, the
  133.     Welcome, News, Menu and Quit screen files have different names.
  134.  
  135.     I think this is a better solution,  in order to isolate all filenames from
  136.     other programs that can have similar names, specially for the Help files.
  137.  
  138.     Simply delete all  older files, and replace them with  the new ones, as is
  139.     described in the above step.
  140.  
  141.   ■ There is a  bug in the [WHO] command. I could  not correct this problem in
  142.     this  version. I  already know  what the  problem is,  but I  do not  have
  143.     enough informations right know in order to correct the problem.
  144.  
  145.     The problem is  that ProKit is reading the USERNET.DAT,  when it should be
  146.     reading the new USERNET.XXX. This is  not exactly a ProKit bug. The latest
  147.     ProKit version simply  is not new enough to have  know about this new file
  148.     and format.
  149.  
  150.     This  problem was  first related  by Mr.Mário  Pozzetti (SysOp  of SkyShip
  151.     BBS), who told why the bug happens.
  152.  
  153.     Also Mr.Pedro Chaves (co-SysOp of MsMac BBS) related this problem.
  154.  
  155.   ■ I have included a ProKit macro  $NONSTOP$ at the beginning of the Welcome,
  156.     News, Menu and  Quit files, in order to  continuously display those files.
  157.     There was some problems found at  SkyShip BBS about this subject, probably
  158.     related with each user page length configuration.
  159.  
  160.     This feature  was suggested by  Mr.Mário Pozzetti (SysOp  of SkyShip BBS).
  161.     Many thanks!
  162.  
  163.   ■ New log off feature.
  164.  
  165.     Now you will be  able to configure the user log off.  That is, you now can
  166.     select which  file is displayed  to the  user  when he logs  off using the
  167.     [G]oodbye, [BYE] or [BY] commands.
  168.  
  169.     By default, unless you specify differently, WonderWho will display the log
  170.     off script questionnaire as specified in PCBOARD.DAT.
  171.  
  172.     However, you can specify a different file, or simply disable this feature.
  173.     Please  refer  to  the  WONDER.CFG  comments  concerning  this option, for
  174.     further details.
  175.  
  176.   ■ Config file
  177.  
  178.     Besides the options already working in the previous version 0.17,
  179.  
  180.         INTERRUPT or BIOS
  181.         DLD_DIR=
  182.         WELCOME_FILE=
  183.         NEWS_FILE=
  184.         MENU_FILE=
  185.         QUIT_FILE=
  186.  
  187.     here is a list of all the new options you cab set:
  188.  
  189.         LANG_FILE=
  190.         LOGOFF=
  191.         OP_LEVEL_X=
  192.         OP_LEVEL_M=
  193.         OP_LEVEL_H=
  194.         OP_LEVEL_G=
  195.         OP_LEVEL_PRO=
  196.         OP_LEVEL_WHO=
  197.         OP_LEVEL_UU=
  198.         OP_LEVEL_UF=
  199.         OP_LEVEL_UD=
  200.         OP_LEVEL_US=
  201.         OP_LEVEL_UP=
  202.         OP_LEVEL_UE=
  203.         OP_LEVEL_UA=
  204.         OP_LEVEL_UR=
  205.         OP_LEVEL_UV=
  206.         OP_LEVEL_UC=
  207.         OP_LEVEL_DU=
  208.         OP_LEVEL_DF=
  209.         OP_LEVEL_DD=
  210.         OP_LEVEL_DS=
  211.         OP_LEVEL_DP=
  212.         OP_LEVEL_DE=
  213.         OP_LEVEL_DA=
  214.         OP_LEVEL_DR=
  215.         OP_LEVEL_DV=
  216.         OP_LEVEL_DC=
  217.         OP_LEVEL_AU=
  218.         OP_LEVEL_AF=
  219.         OP_LEVEL_AD=
  220.         OP_LEVEL_AS=
  221.         OP_LEVEL_AP=
  222.         OP_LEVEL_AE=
  223.         OP_LEVEL_AA=
  224.         OP_LEVEL_AR=
  225.         OP_LEVEL_AV=
  226.         OP_LEVEL_AC=
  227.  
  228.     So,  except for  the INTERRUPT  or BIOS  option, all  other options in the
  229.     original  included WONDER.CFG  file are  disabled. WonderWho  doesn't need
  230.     that  you  un-disable  the  options  in  order  to  work  properly. Still,
  231.     WonderWho  remains plug  and play!  Nevertheless, you  may want  to change
  232.     things, and you can do it!
  233.  
  234.     One of the interesting things of the above options, is that the SysOp have
  235.     now full control about the security level  a user must have in order to be
  236.     allowed  to execute  a command.  By the  default, all  commands are set to
  237.     security level 0 (zero).
  238.  
  239.     You cannot set security levels for  the two [VER]sion commands and also to
  240.     the two [Q]uit commands.
  241.  
  242.   ■ Language file.
  243.  
  244.     This is a  new and very powerful feature of  WonderWho. It was foreseen in
  245.     my mind for  quite a while. Support to  this file was created in  order to
  246.     provide SysOp's a way to change the  names of all commands (except the two
  247.     [VER]sion commands).
  248.  
  249.     Here is a list of all options you can set:
  250.  
  251.         OP_NAME_X=
  252.         OP_NAME_M=
  253.         OP_NAME_H=
  254.         OP_NAME_Q=
  255.         OP_NAME_G=
  256.         OP_NAME_PRO=
  257.         OP_NAME_WHO=
  258.         OP_NAME_UU=
  259.         OP_NAME_UF=
  260.         OP_NAME_UD=
  261.         OP_NAME_US=
  262.         OP_NAME_UP=
  263.         OP_NAME_UE=
  264.         OP_NAME_UA=
  265.         OP_NAME_UR=
  266.         OP_NAME_UV=
  267.         OP_NAME_UC=
  268.         OP_NAME_DU=
  269.         OP_NAME_DF=
  270.         OP_NAME_DD=
  271.         OP_NAME_DS=
  272.         OP_NAME_DP=
  273.         OP_NAME_DE=
  274.         OP_NAME_DA=
  275.         OP_NAME_DR=
  276.         OP_NAME_DV=
  277.         OP_NAME_DC=
  278.         OP_NAME_AU=
  279.         OP_NAME_AF=
  280.         OP_NAME_AD=
  281.         OP_NAME_AS=
  282.         OP_NAME_AP=
  283.         OP_NAME_AE=
  284.         OP_NAME_AA=
  285.         OP_NAME_AR=
  286.         OP_NAME_AV=
  287.         OP_NAME_AC=
  288.  
  289.     Please refer to  the WW_LANG file comments, for  further details about all
  290.     the above options.
  291.  
  292.     You cannot set names for the two [VER]sion commands.
  293.  
  294.     This file  looks like a WONDER.CFG  config file. And it  almost is. You ca
  295.     have as many language files as you want.  That is, you can have 1 file per
  296.     each language you  have installed in your PCBoard  system. By default this
  297.     file  is called  "WW_LANG" but  you can  specify a  different name  in the
  298.     WONDER.CFG config  file. No path is  allowed: file must be  located in the
  299.     same directory  where the config  file is. Also,  you can not  specify the
  300.     file extension, because WonderWho will  add the file extension accordingly
  301.     to the PCBoard  active Language Extension (as happens,  for instance, with
  302.     the Main Menu file).
  303.  
  304.     So, you can configure the door commands for all languages you may want, by
  305.     creating one Language file for each language. The default Language file is
  306.     the  one  that  cannot  have  file  extension  (as  in PCBoard). All other
  307.     Language files must have the same extension as you defined in PCBML.DAT.
  308.  
  309.     If the user is currently using  a specific language other than the default
  310.     one, then WonderWho will look for a file with that extension. If he founds
  311.     the file it will  read it. If not, it will read  the default file, the one
  312.     without an extension.
  313.  
  314.     All options in the original  included WW_LANG file are disabled. WonderWho
  315.     doesn't need  that you un-disable the  options in order to  work properly.
  316.     Still,  WonderWho remains  plug and  play! Nevertheless,  you may  want to
  317.     change things, and you can do it!
  318.  
  319.     Besides all this, there is another major and powerful thing that WonderWho
  320.     permits  when using  the Languages  files. The  routine that processes the
  321.     Language files is the very same that processes the WONDER.CFG config file.
  322.     The very same! This means that anything (really *ANYTHING*) you can set in
  323.     the WONDER.CFG you can set (and overwrite) in the Language files.
  324.  
  325.     So,  besides you  setting things  in the  WONDER.CFG file  you can specify
  326.     language specific settings in each Language file. This gives you SysOp the
  327.     total control about the WonderWho door!
  328.  
  329.   ■ News date limit
  330.  
  331.     SysOp's can  now specify a  date limit after  which the WW_NEWS  news file
  332.     stops to be displayed to the users.  This is done in the WONDER.CFG config
  333.     file (available in Language files too) using the following option:
  334.  
  335.         NEWS_LIMIT=
  336.  
  337.     Please  refer to  the WONDER.CFG   comments for  further details.  In this
  338.     version, by default, NEWS_LIMIT= is set to 1993-03-31 (yyyy-mm-dd);
  339.  
  340.   ■ Corrected bug  in the routine that saves log  errors to $DOOR.ERR file. It
  341.     was saving empty lines in some cases.
  342.  
  343.   ■ This version of WonderWho requires about 183 KBytes of RAM to run (1 KByte
  344.     more than previous version).
  345.  
  346. ------------------------------------------------------------------------------
  347. WonderWho v0.17:  Feb 29, 1993
  348. ------------------------------------------------------------------------------
  349.  
  350.   ■ If you are updating from the  previous version 0.16, you will only need to
  351.     overwrite or add the following files:
  352.  
  353.         WONDER.EXE
  354.         WONDER.CFG     (see bellow)
  355.         WONDER_M
  356.         HELP_WHO       (this is new!)
  357.         HISTORY.TXT
  358.  
  359.     That's all! But please continue to read this file.
  360.  
  361.   ■ Added another command: [WHO] is on another node ?
  362.  
  363.     This is always a useful command. Now  WonderWho has it! The Help files for
  364.     this commands are included.
  365.  
  366.   ■ All yes/no prompt questions,  besides the conventional"n" and "y" answers,
  367.     now also supports "yes" and "no" answers, either in uppercase or lowercase
  368.     letters.
  369.  
  370.     Mr.Pedro Duarte, at SkyShip BBS, told me  that, in face of a yes/no prompt
  371.     question, he answered  "no", and WonderWho (by the  time still JAwho) took
  372.     his answer as a  "yes". And he found it rather strange,  and related it to
  373.     me as a  bug. Well, this was not  a bug. Simply I didn't  cared about this
  374.     subject, and so I didn't implemented  this feature. But of course this was
  375.     kind of stupid:  if a user type a "no"  answer, WonderWho MUST process the
  376.     user's answer as a "no", and not as a "yes"...
  377.  
  378.     Many thanks to Mr.Pedro Duarte for reminding me this!
  379.  
  380.   ■ Started to build the  configuration file WONDER.CFG. The following options
  381.     can are currently available in this version of WonderWho:
  382.  
  383.         DLD_DIR=
  384.         WELCOME_FILE=
  385.         NEWS_FILE=
  386.         MENU_FILE=
  387.         QUIT_FILE=
  388.  
  389.     Please carefully  read instructions written  in the file.  Unless you have
  390.     particular reasons, you do NOT need to change this file.
  391.  
  392.   ■ Minor program enhancements.
  393.  
  394. ------------------------------------------------------------------------------
  395. WonderWho v0.16:  Feb 28, 1993
  396. ------------------------------------------------------------------------------
  397.  
  398.   ■ From  now on, this door  will be called WonderWho  instead of JAwho. There
  399.     four major reasons for this change.  First, nobody liked the name. Several
  400.     SkyShip  BBS  users  have  send  me  messages  telling  me this. They also
  401.     proposed alternative  and very interesting names.  I appreciated very much
  402.     their  concern. I  also did  not liked  the name  two, after  the moment I
  403.     realized how  "JAwho" sounds in english.  It sounds awful... Third,  it is
  404.     much more easy to remember. Forth, this new name tells more about what the
  405.     door is.
  406.  
  407.     Except for BBSs that have a door manager installed (such as DoorBill), the
  408.     loggies should now enter WONDER instead of JAWHO command.
  409.  
  410.   ■ If you are updating from the  previous version 0.15, you will only need to
  411.     delete  ALL previous  files, overwrite  ALL this  new files, and configure
  412.     directory names,  paths, etc, from scratch.  I am terribly sorry  for this
  413.     inconvenient.
  414.  
  415.   ■ Besides  [G] and [BYE], WonderWho  also recognizes the [BY]  command. This
  416.     new [BY] acts like [BYE], and this appears for more compatibility with the
  417.     PCBoard commands.
  418.  
  419.     This  feature  was  proposed  by   Mr.Afonso  Vicente  (SysOp  of  Intriga
  420.     Internacional). Many thanks to him!
  421.  
  422.   ■ Added the parameter "Y" to the [G]oodbye command. If a user type:
  423.  
  424.         "G Y"
  425.  
  426.     at the command prompt, this will act exactly as the [BYE] command. It logs
  427.     off without prompting anything, as PCBoard also does.
  428.  
  429.     This feature was suggested by Mr.Afonso Vicente. Many thanks to him!
  430.  
  431.   ■ Revised  the  HELP_G.*  screen,  and   inserted  information about the new
  432.     [G]oodbye  exclusive parameter  "Y". A  suggestion was  made by  Mr.Afonso
  433.     Vicente, who remarked that the ALT-X  command was not, in a communications
  434.     program, the usual  command to Hang-Up, but the  ALT-H. Again, many thanks
  435.     to him!
  436.  
  437.   ■ I have made some small revisions in this HISTORY.TXT file.
  438.  
  439.   ■ Finished the last three commands:
  440.  
  441.       [US], [DS] and [AS] Since date
  442.  
  443.     Again, there is nothing much to say about this. Try it !
  444.  
  445.   ■ Revised output search headers for all search commands.
  446.  
  447.   ■ Errors and Average CPS commands, now displays the found field in White
  448.     On Black color.
  449.  
  450.   ■ Here  is  a list  of all  new commands  with Help  files concluded in this
  451.     version:
  452.  
  453.         HELP_US    (since date)
  454.         HELP_DS
  455.         HELP_AS
  456.  
  457.     These are new files. The last Help files that were missing.
  458.  
  459.   ■ Removed  the  HELP_$$ and  HELP_$$.TD files.  These files  are not anymore
  460.     required by  WonderWho, because all  Help files for  all commands are  now
  461.     available.
  462.  
  463.   ■ Revised  the Main Menu  file WONDER_M in  the System section.  Removed the
  464.     "yellow options are available", are re-arranged the free space.
  465.  
  466.   ■ This version of WonderWho requires about 182 KBytes of RAM to run.
  467.  
  468.   ■ The future will be putting  WonderWho working with the configuration file,
  469.     an write the Documentation.
  470.  
  471. ------------------------------------------------------------------------------
  472. JAwho v0.15:  Feb 26, 1993
  473. ------------------------------------------------------------------------------
  474.  
  475.   ■ If you are updating from the  previous version 0.14, you will only need to
  476.     overwrite or add the following files:
  477.  
  478.         JAWHO.EXE
  479.         JAWHO_M
  480.         JAWHO_N
  481.         HELP_UE          (this is new!)
  482.         HELP_DE          (this is new!)
  483.         HELP_AE          (this is new!)
  484.         HELP_UA          (this is new!)
  485.         HELP_DA          (this is new!)
  486.         HELP_AA          (this is new!)
  487.         HELP_UV          (this is new!)
  488.         HELP_DV          (this is new!)
  489.         HELP_AV          (this is new!)
  490.         HISTORY.TXT
  491.  
  492.     That's all! But please continue to read this file.
  493.  
  494.   ■ Changed the routine that searches the scan entries in a DOWNLOAD.TXT entry
  495.     line back to Turbo Pascal, instead of using fast Assembler code as in last
  496.     previous versions. Probably the performance  for this step decreased about
  497.     14%,  because at  the time  of the  first inclusion  of assembler  in this
  498.     routine, the results gave me 14% faster running.
  499.  
  500.     The reason of  this change its because of a  bug in the assembler routine.
  501.     Some times the  routine finds what it searches, sometimes  not (but it was
  502.     there). I  really don't know the  reason why this happens.  Apparently the
  503.     assembler was very erroneous and not perfectly stable.
  504.  
  505.     This bug  was related by  Mr.Pedro Duarte at  SkyShip BBS. Many  thanks to
  506.     him! This bug was detected in a kind of amusing situation! Mr.Pedro Duarte
  507.     tried to find entries for its wonderful LusoComm program, and also for the
  508.     JAwho program. JAwho,  in a very envious and  despicable attitude, did not
  509.     showed to him the LusoComm entries, only JAwho entries...
  510.  
  511.   ■ Finished more three commands, [UE], [DE] and [AE] Transfer Errors.
  512.     There is nothing much to speak about. See for yourself and read the Help.
  513.  
  514.   ■ Finished more three commands, [UA], [DA] and [AA] Average CPS.
  515.     There is nothing much to speak about. See for yourself and read the Help.
  516.  
  517.   ■ Finished more three commands, [UV], [DV] and [AV] Verbose list.
  518.     There is nothing much to speak about. See for yourself and read the Help.
  519.  
  520.   ■ Here  is  a list  of all  new commands  with Help  files concluded in this
  521.     version:
  522.  
  523.         HELP_UE    (transfer errors)
  524.         HELP_DE
  525.         HELP_AE
  526.         HELP_UA    (average cps)
  527.         HELP_DA
  528.         HELP_AA
  529.         HELP_UV    (verbose)
  530.         HELP_DV
  531.         HELP_AV
  532.  
  533. ------------------------------------------------------------------------------
  534. JAwho v0.14:  Feb 25, 1993
  535. ------------------------------------------------------------------------------
  536.  
  537.   ■ If you are updating from the  previous version 0.13, you will only need to
  538.     overwrite or add the following files:
  539.  
  540.         JAWHO.EXE
  541.         JAWHO_N          (this is new!)
  542.         HISTORY.TXT
  543.  
  544.     That's all! But please continue to read this file.
  545.  
  546.   ■ Beginning with  this version, JAwho now supports writes  to the LOG CALLER
  547.     file. This is amazing! As usual, multinode support is available.
  548.  
  549.     Here follows an example, which I think is self-explanative. JAwho specific
  550.     lines are the ones marked with a "->".
  551.  
  552.             "**************************************************************"
  553.             "02-24-93 (09:03) (1) JOSE ALMEIDA (Local) (G)                 "
  554.             "      Caller Number: 880                                      "
  555.             "      Caller Security: 110                                    "
  556.             "      Opened Door (JAWHO) at 09:03                            "
  557.         ->  "      (AU)  # 1: JOSE ALMEIDA                                 "
  558.         ->  "      (UF)  # 1: JAWHO012.ZIP                                 "
  559.         ->  "            # 2: JAWHO013.ZIP                                 "
  560.         ->  "            # 3: JAWHO014.ZIP                                 "
  561.         ->  "      (DC)  Count entries                                     "
  562.         ->  "      (PRO) View user profile                                 "
  563.         ->  "      (X)   Expert mode is now on                             "
  564.         ->  "      (M)   Graphics mode is now off                          "
  565.         ->  "      (VER) Program version info                              "
  566.         ->  "      (H)   Help about: (PRO)                                 "
  567.         ->  "      (G)   Goodbye (from inside door)                        "
  568.             "      Minutes Used: 1                                         "
  569.             "02-24-93 (09:04) (1) JOSE ALMEIDA Off Automatically           "
  570.             "**************************************************************"
  571.  
  572.     All  search entries  are logged,  except for  the [Q]uit command. Trailing
  573.     characters past each log entry is filled with ASCII #255 for clear output,
  574.     and in order  to allow the file to  be edit without any problem  caused by
  575.     ASCII text  editors discards trailing  space characters. All  call entries
  576.     are saved prior to execute the command, for convenient debug operations.
  577.  
  578.     JAwho will  not save to  LOG CALLER file  if in Local  Test mode (when you
  579.     pass the word  "LOCAL" as the third parameter to  the program). But ProKit
  580.     itself does this anyway, if a "Keyboard Time Expired!" takes place.
  581.  
  582.     In future,  with the presence  of the configuration  file, the LOG  CALLER
  583.     writes can be disabled.
  584.  
  585.   ■ Corrected (I hope) error concerning the multi-language file support. JAwho
  586.     processes Welcome, Menu, Quit and Helps files as follow:
  587.  
  588.         1.: Gets the PCBoard language extension.
  589.  
  590.         2.: Locate  the  file with  the proper  extension returned  by PCBoard
  591.             (which can be none).
  592.  
  593.         3.: If the file was found, then the file is displayed.
  594.  
  595.         4.: If the file was not found, then:
  596.  
  597.               4.1: If file extension in none, the file is not displayed.
  598.                    Returns an error.
  599.  
  600.               4.2: If  file extension is  not none, then  tries to locate  the
  601.                    same file,  without extension.
  602.  
  603.                    4.2.1: If the file was found, then the file is displayed.
  604.  
  605.                    4.2.2: If  the  file was  not found,  then the  file is not
  606.                           displayed.
  607.                           Returns an error.
  608.  
  609.     This process was, and still is, the process I have implemented. Except one
  610.     thing I have  changed. The routine that locates the  files was not working
  611.     properly when in a network environment. So I switch from my own routine to
  612.     the equivalent ProKit routine, that supports networks.
  613.  
  614.     Many thanks  to Mr.Pedro Chaves,  Co-SysOp of MsMac  BBS, who related  the
  615.     problem.
  616.  
  617.     As  it  happens  in  all  other  previous  versions  of JAwho, SysOps with
  618.     multi-language  systems can  create language  dependent files  in order to
  619.     work  with  JAwho.  This  also  includes  the  Help  files. But, even in a
  620.     multi-language systems SysOps do not  need to create those files. Because,
  621.     as I said bellow, JAwho will display the files without language extension,
  622.     if the proper file is not found.
  623.  
  624.   ■ Rewritten the error log routines.
  625.  
  626.       1. Now it is ProKit itself that verifies the number of parameters passed
  627.          to the door.
  628.  
  629.       2. All errors  are now displayed both to local  screen and to the remote
  630.          user (probably except  the one listed above, I'm  not sure). But they
  631.          look the  same as in previous  versions. I created a  special string:
  632.          "Please notify the SysOp, @FIRST@..." in order to your users send you
  633.          relate you the problem.
  634.  
  635.       3. Errors are saved in $DOOR.ERR either by ProKit (always in the current
  636.          directory) or by JAwho itself (in the door directory).
  637.  
  638.       4. Remember, if a Welcome, Menu, Quit or Help files are not found at all
  639.          (considering something  I have said above  in the multi-language file
  640.          support) JAwho will display an error. But does not exit to PCBoard.
  641.  
  642.       5. Errors are not saved into CALLER's log.
  643.  
  644.   ■ Added support for a NEWS file. This filename is: JAWHO_N.
  645.  
  646.     This file is provided originally by me, each new version of JAwho, listing
  647.     new features  and changes. But  not necessarily all:  only the things  the
  648.     users should now about.
  649.  
  650.     This file is  taken care in almost the  same way is done for  the Welcome,
  651.     Menu, Quit and Help files.
  652.  
  653.     You can edit  this file, if you want,  or simply delete it. If  you delete
  654.     the file, JAwho won't care about it.  It won't display an error, even. So,
  655.     a special  treatment goes around this  file. Still, multi-language support
  656.     is available.
  657.  
  658.     By  the time  the JAwho  configuration file  is available,  in future, the
  659.     SysOp will  have the possibility  to specify a  date after which  the file
  660.     will be no longer displayed to the  user, let's say a date that represents
  661.     a month  after installing each  new version of  JAwho. By doing  this, the
  662.     News file will be displayed only until that date in reached. And the SysOp
  663.     will not need to remember or care about this.
  664.  
  665.   ■ At last, LICENSE.DOC and ORDER.FRM are included.
  666.  
  667. ------------------------------------------------------------------------------
  668. JAwho v0.13:  Feb 24, 1993
  669. ------------------------------------------------------------------------------
  670.  
  671.   ■ If you are updating from the  previous version 0.12, you will only need to
  672.     overwrite or add the following files:
  673.  
  674.         JAWHO.EXE
  675.         JAWHO_M.
  676.         HELP_PRO.
  677.         HELP_UC.
  678.         HELP_DC.
  679.         HELP_AC.
  680.         HISTORY.TXT
  681.  
  682.     That's all! But please continue to read this file.
  683.  
  684.   ■ Concluded the [PRO]file command.
  685.  
  686.   ■ Added a sound beep at the time of displaying the statistics It advises the
  687.     user that the search as been concluded.
  688.  
  689.   ■ Statistics  could  display more  than 100.00%  in the  "Total uploads"  or
  690.     "Total downloads" fields, if the "Total search item(s) found" was equal to
  691.     one of them. This has been fixed.
  692.  
  693.   ■ In the statistics, the accuracy of the following fields has been increased
  694.     to 2 decimals digits:
  695.  
  696.         ■ "Average number of errors"
  697.         ■ "Average CPS"
  698.  
  699.   ■ Revised the statistics, in the aspects described bellow.
  700.     I think this way is preferable.
  701.  
  702.         ■ JAwho  was  displaying the  LAST older  filedate found  in a matched
  703.           search. Now displays the FIRST.
  704.  
  705.         ■ JAwho  was  displaying the  LAST newer  filedate found  in a matched
  706.           search. Now displays the FIRST.
  707.  
  708.         ■ JAwho  was  displaying the  LAST worse  number of  errors found in a
  709.           matched search. Now displays the FIRST.
  710.  
  711.         ■ JAwho  was  displaying the  LAST best  number of  errors found  in a
  712.           matched search. Now displays the FIRST.
  713.  
  714.         ■ JAwho was  displaying the LAST worse CPS found  in a matched search.
  715.           Now displays the FIRST.
  716.  
  717.         ■ JAwho  was displaying the LAST  best CPS found in  a matched search.
  718.           Now displays the FIRST.
  719.  
  720.   ■ Minor  screen  revisions in   the search  items prompt.  Nothing important
  721.     enough to speak of.
  722.  
  723.   ■ Concluded  the  [UC], [DC]  and [AC]  count commands.  Help files are also
  724.     available and included.
  725.  
  726.   ■ Increased  the  DOWNLOAD.TXT file  buffer size  from 4096  bytes to  10240
  727.     bytes. This should increase global search speed in about 17% or so.
  728.  
  729.   ■ Here  is  a list  of all  new commands  with Help  files concluded in this
  730.     version:
  731.  
  732.         HELP_PRO   (profile user)
  733.         HELP_UC    (count)
  734.         HELP_DC
  735.         HELP_AC
  736.  
  737.   ■ The TheDraw  *.TD Welcome, Menu, Quit and Help  files, are now included in
  738.     the package in a ZIP archive.  Filename is: TD_FILES.ZIP. So, if you don't
  739.     plan  to use  them, simply  leave them  in the  ZIP archive  in the  JAwho
  740.     directory along  with the other files.  This will give you  a more "clean"
  741.     JAwho directory.
  742.  
  743.   ■ This version of JAwho requires about 177 KBytes of RAM to run.
  744.  
  745. ------------------------------------------------------------------------------
  746. JAwho v0.12:  Feb 23, 1993
  747. ------------------------------------------------------------------------------
  748.  
  749.   ■ If you are updating from the previous version 0.11, you will only need
  750.     to overwrite or add the following files:
  751.  
  752.         JAWHO.EXE
  753.         HELP_G.
  754.         HELP_G.TD
  755.         HELP_H.
  756.         HELP_H.TD
  757.         HELP_M.
  758.         HELP_M.TD
  759.         HELP_Q.
  760.         HELP_Q.TD
  761.         HELP_VER.
  762.         HELP_VER.TD
  763.         HELP_X.
  764.         HELP_X.TD
  765.         HISTORY.TXT
  766.  
  767.     That's all! But please continue to read this file.
  768.  
  769.   ■ Here  is  a list  of all  new commands  with Help  files concluded in this
  770.     version:
  771.  
  772.         HELP_G     (goodbye)
  773.         HELP_H     (help on help)
  774.         HELP_M     (mode graphics)
  775.         HELP_Q     (quit)
  776.         HELP_VER   (version information)
  777.         HELP_X     (expert mode)
  778.  
  779.     You must copy this files to the JAwho directory.
  780.  
  781.   ■ JAwho  now  again recognizes  the older  [VERSION] command.  So, [VER] and
  782.     [VERSION] will both be valid commands, and act in exactly the same way.
  783.  
  784.   ■ The [H]elp  command is also recognized by  JAwho as [HELP]. This is  not a
  785.     new feature of this version. But I  think I did not said this before. Both
  786.     commands act exactly the same way.
  787.  
  788.   ■ JAwho now also recognizes the [?] command as Help request. All [H], [HELP]
  789.     and [?] act in exactly the same way.
  790.  
  791.   ■ Some small color screen bugs have been corrected, in the [X]pert and [M]de
  792.     graphics commands. Nothing important to speak of.
  793.  
  794. ------------------------------------------------------------------------------
  795. JAwho v0.11:  Feb 21, 1993
  796. ------------------------------------------------------------------------------
  797.  
  798.   ■ If you are updating from the  previous version 0.10, you will only need to
  799.     overwrite the following files:
  800.  
  801.         JAWHO.EXE
  802.         JAWHO_M.
  803.         JAWHO_M.TD
  804.         JAWHO_Q.TD     (only this)
  805.         JAWHO_W.TD     (only this)
  806.         HELP*.*        (*** all of them ***)
  807.         HISTORY.TXT
  808.  
  809.     And delete the  following files, because JAwho do NOT  use it anymore (see
  810.     bellow the reason why this happens):
  811.  
  812.         HELP.
  813.         HELP.TD
  814.  
  815.     That's all! But please continue to read this file.
  816.  
  817.   ■ Added  the [G]oodbye option. JAwho  also recognizes the [BYE]  command. If
  818.     the user enters [G] then JAwho will ask:
  819.  
  820.         "Proceed with logoff (Enter)=No ?".
  821.  
  822.     If the user enters  [BYE] then no question will be asked  to the user. So,
  823.     JAwho handles this command the same way PCBoard does.
  824.  
  825.     In both cases, JAwho will also display, before dropping DTR:
  826.  
  827.         "Minutes used: @TIMEUSED@"
  828.  
  829.         "Thanks for calling, @FIRST@, and goodbye!"
  830.  
  831.     Thanks  to Mr.Mário  Pozzetti (SysOp   of SkyShip  BBS) who  proposed this
  832.     command.
  833.  
  834.   ■ Corrected  some  bugs  regarding   the  Carrier  Lost,  Keyboard   Expired
  835.     situations.
  836.  
  837.   ■ JAwho no longer displays the ProKit........... message when exiting.
  838.  
  839.   ■ Benchmark test:
  840.  
  841.         BBS       : SkyShip BBS
  842.         NODE      : Node #3 (node #1 is the server)
  843.         NETWORK   : Lantastic
  844.         CONNECTION: 38,400 baud
  845.  
  846.         Search    : DF JAWHO
  847.  
  848.         JAwho  took  17  seconds  to  find  7  entries  in 13,665 lines of the
  849.         DOWNLOAD.TXT file.
  850.  
  851.   ■ Revised the  Menu screen. Re-arranged the System  group. Looks much better
  852.     now, and leaves space for four future commands.
  853.  
  854.   ■ Some  Help  text files  are now  available and  fully working.  Proceed as
  855.     follow.  Delete  the  older  two  Help  files  from previous version 0.10,
  856.     because JAwho no longer reads them:
  857.  
  858.        HELP.
  859.        HELP.TD
  860.  
  861.     This were only  used as temporary files for the  last version, in order to
  862.     put JAwho working properly with the  Help system. Now both files have been
  863.     substituted by two other ones:
  864.  
  865.        HELP_$$.
  866.        HELP_$$.TD
  867.  
  868.     Still these two files are being used  only to provide no errors. This file
  869.     says that there are no Help available  for that command, because it is not
  870.     ready at this time.
  871.  
  872.     Now, you must copy all the HELP*.*  files to the same directory were JAwho
  873.     is  stored. Each  group of  two files  with the  same name represents Help
  874.     description for just one command. Example: HELP_UU and HELP_UU.TD.
  875.  
  876.     As I said  before, all *.TD files are native  TheDraw files used to design
  877.     each screen. JAwho itself does not  need these TheDraw files, and they may
  878.     be deleted  if SysOp wants  to. They are  included for the  only reason of
  879.     giving the SysOp the possibility to edit the original files, for instance,
  880.     for translating purposes, using the very same design.
  881.  
  882.     Here is a list of all commands with Help files available at this time:
  883.  
  884.         HELP_UU    (user name)
  885.         HELP_DU
  886.         HELP_AU
  887.  
  888.         HELP_UF    (file name)
  889.         HELP_DF
  890.         HELP_AF
  891.  
  892.         HELP_UD    (date)
  893.         HELP_DD
  894.         HELP_AD
  895.  
  896.         HELP_UP    (protocol)
  897.         HELP_DP
  898.         HELP_AP
  899.  
  900.         HELP_UR    (raw)
  901.         HELP_DR
  902.         HELP_AR
  903.  
  904. ------------------------------------------------------------------------------
  905. JAwho v0.10:  Feb 19, 1993
  906. ------------------------------------------------------------------------------
  907.  
  908.   ■ If you are updating from the  previous version 0.09, you will only need to
  909.     overwrite the following files:
  910.  
  911.         JAWHO.EXE
  912.         JAWHO_M.
  913.         JAWHO_M.TD
  914.         HELP.
  915.         HELP.TD
  916.         HISTORY.TXT
  917.  
  918.     That's all! But please continue to read this file.
  919.  
  920.   ■ Changed the command "Version Info" from [VERSION] to [VER].
  921.  
  922.   ■ Finished the following commands:
  923.  
  924.         [UP] Upload Protocol
  925.         [DP] Download Protocol
  926.         [AP] All Protocol
  927.  
  928.   ■ Accuracy of the percentage numbers  in the statistics have been increased,
  929.     and now displays 2 decimals floating point numbers.
  930.  
  931.   ■ Added support for some protocols that makes PCB to put the word "External"
  932.     in  the Average  CPS field.  Now JAwho  no longer  treats this  case as  a
  933.     "Corrupted entry!". Instead,  it displays "Ext." in the  CPS field (except
  934.     when in Raw searches, which displays whatever he founds there).
  935.  
  936.     When the  "External" word is  found in the  CPS field, the  entry will not
  937.     count for the calculation of:
  938.  
  939.         Best CPS
  940.         Worst CPS
  941.  
  942.     of the statistics. Of course, because the entry is valid, this will affect
  943.     calculation  of Average  CPS. Average  CPS is  calculated by the following
  944.     formula: the  sum of all CPS  fields of each DOWNLOAD.TXT  entry line that
  945.     matches  the search,  divided by  the total  number of  DOWNLOAD.TXT entry
  946.     lines that matches  the search. This calculation is only  done by the time
  947.     JAwho displays the statistics.
  948.  
  949.     In this  particular case I  am dealing here,  this means, in  other words,
  950.     each time DOWNLOAD.TXT entry line  matches the search, JAwho will increase
  951.     the number of entries found by 1,  but JAwho will not increase the Average
  952.     CPS account.
  953.  
  954.     So,  Average  CPS  will  be  calculated  without  100%  accuracy, when the
  955.     "External"  word  is  found.  Nevertheless,  it  is calculated, and should
  956.     represent approximately the true Average CPS.
  957.  
  958.     I  have found  the "External"  word in  two different  situations, in  two
  959.     different BBSs (both systems using PCboard v14.5a/10):
  960.  
  961.         1) At SkyShip  BBS, were the problem was first  detected, only 1 entry
  962.            in more  than 12,000 lines  were found. The  protocol used in  that
  963.            specific case  was HS/Link in  a bi-directional transfer.  Mr.Mário
  964.            Pozzetti (the SysOp)  and I, found this to be  very strange, and we
  965.            though that this was a 1 in 12,000 case. Nothing to be cared about,
  966.            so.
  967.  
  968.         2) However, at Intriga Internacional  BBS, 182 entries in almost 3,000
  969.            lines were  found. But ALL  entries were LOCAL  SysOp uploads using
  970.            PCBoard's Ymodem/G internal protocol. Still is, strange...
  971.  
  972.     Many thanks to  Mr.Mário Pozzetti and Mr.Afonso Vicente  (SysOp of Intriga
  973.     Internacional BBS), who help me to get this thing almost cleared out.
  974.  
  975.   ■ Besides the  [Q]quit option, now JAwho will  also understands [QUIT]. Both
  976.     commands are the same, off course.
  977.  
  978.   ■ Revised  the command line  prompt system. It  looks the same,  but in some
  979.     cases JAwho  was displaying two empty  lines, when it should  display only
  980.     one. This no longer happens.
  981.  
  982.   ■ Help system is  ready to work. The command to call the  Help can be [H] or
  983.     [HELP]. Help  systems supports multi-language,  and works the  same way as
  984.     other JAwho files, and the PCBoard Help files.
  985.  
  986.     As soon  as possible, probably next  version, all the Help  text files for
  987.     available working commands will be included in JAwho Package.
  988.  
  989.     For the time  being, only HELP. is provided. Please  copy this file to the
  990.     JAwho directory, where all Help text files should be also located.
  991.  
  992.   ■ This is a note, not a new feature:
  993.  
  994.     If you  wish to change the  JAwho screens, using the  included *.TD files,
  995.     you should get  a program named PCBX. This is  a TSR utility that captures
  996.     the  contents of  a screen  (full or  region) and  saves it  to disk using
  997.     PCBoard @X?? color codes fully supported by JAwho.
  998.  
  999.     This is a way I do the screens for JAwho.
  1000.  
  1001. ------------------------------------------------------------------------------
  1002. JAwho v0.09:  Feb 18, 1993
  1003. ------------------------------------------------------------------------------
  1004.  
  1005.   ■ If you are updating from the  previous version 0.08, you will only need to
  1006.     overwrite the following files:
  1007.  
  1008.         JAWHO.EXE
  1009.         HISTORY.TXT
  1010.  
  1011.     And delete the  following files, because JAwho do NOT  use it anymore (see
  1012.     bellow the reason why this happens):
  1013.  
  1014.         JAWHO_I
  1015.         JAWHO_I.TD
  1016.  
  1017.     That's all! But please continue to read this file.
  1018.  
  1019.   ■ I have made some enhancements in the statistics.
  1020.  
  1021.     JAwho now formats  better the screen outputted text, and  in some cases it
  1022.     also shows at which entry the issue was found. Very nice, I think.
  1023.  
  1024.   ■ Added a  Yes/No question before displaying the statistics.  So, a user can
  1025.     now decide not to see the statistics, if he prefers.
  1026.  
  1027.   ■ Command  line search items input  has been totally rewritten.  And this is
  1028.     why JAwho doesn't look anymore for the JAWHO_I. Instructions files.
  1029.  
  1030.     Now it has a PCBoard download prompt  style for search items. I think this
  1031.     is quite better interface for doing such inputs. But, see for yourself.
  1032.  
  1033.     Added a Yes/No question is prompted before starting searches. The user can
  1034.     now abort, after he specifies the search items.
  1035.  
  1036.     Many thanks  to Mr.Pedro Duarte who  gave me some ideas  about this, while
  1037.     discussing the  JAwho door with me,  in public, in the  Main Conference of
  1038.     SkyShip BBS. Mr.Duarte is author  of an extremely very good communications
  1039.     shareware program named LusoComm. Take a look as soon as possible!
  1040.  
  1041.   ■ I  think I did  not said before  that JAwho command  line is "buffered". I
  1042.     mean,  in almost  any part  of the  program (except  when prompting yes/no
  1043.     question,  more?, etc)  you can  immediately type  a new  command and  its
  1044.     parameters. Try it!
  1045.  
  1046.   ■ I also think that I did not  said before that SysOps can Chat and Shell to
  1047.     DOS, along with many other options, from within JAwho.
  1048.  
  1049. ------------------------------------------------------------------------------
  1050. JAwho v0.08:  Feb 18, 1993
  1051. ------------------------------------------------------------------------------
  1052.  
  1053.   ■ If you are updating from the  previous version 0.07, you will only need to
  1054.     overwrite the following files:
  1055.  
  1056.         JAWHO.EXE
  1057.         HISTORY.TXT
  1058.  
  1059.     That's all! But please continue to read this file.
  1060.  
  1061.   ■ Added  the  [VERSION]  command.  This  will  display  the  JAwho  version,
  1062.     copyright and register  information, as well as the  worldwide SkyShip BBS
  1063.     support and Portugal co-support The  Image Bank BBS, telephone numbers and
  1064.     international network conferences.
  1065.  
  1066.     I think this  command will not be listed  in the Menu screen, but  will be
  1067.     mentioned elsewhere in the future help procedures.
  1068.  
  1069.   ■ Corrected "Division by zero" run-time error. This was happening when JAwho
  1070.     did not found any item specified by the user in a search command. Then, by
  1071.     the time of displaying the statistics, some math operations were: 0 div 0.
  1072.     Now a check is taken, before performing those math operations.
  1073.  
  1074.     Many thanks to Mr.Tiago Pascoal, who  detected this bug before I did. But,
  1075.     curiously, by the time I reed its message from SkyShip BBS, I already have
  1076.     detected and eliminated the bug.
  1077.  
  1078. ------------------------------------------------------------------------------
  1079. JAwho v0.07:  Feb 17, 1993
  1080. ------------------------------------------------------------------------------
  1081.  
  1082.   ■ If you are updating from the  previous version 0.06, you will only need to
  1083.     overwrite the following files:
  1084.  
  1085.         JAWHO.EXE
  1086.         JAWHO_M.
  1087.         JAWHO_M.TD
  1088.         HISTORY.TXT
  1089.  
  1090.     That's all! But please continue to read this file.
  1091.  
  1092.   ■ The  program was displaying "JAwho  v0.04" instead of "JAwho  v0.06". This
  1093.     has been corrected, and in this version displays "JAwho v0.07".
  1094.  
  1095.   ■ More 16  commands were added to the Menu,  which now displays 34 commands.
  1096.     This new commands are not yet  available. The available commands still are
  1097.     the ones from version 0.06.
  1098.  
  1099.   ■ Increased the DOWNLOAD.TXT file buffer size from 2048 bytes to 4096 bytes.
  1100.     This should somehow increase speed. But not much.
  1101.  
  1102.   ■ Revised  the  critical routines  which search  for the  ";" characters and
  1103.     positions  in  a  DOWNLOAD.TXT  entry  line,  using  fast  Assembler code.
  1104.     Performance increased about 36 %.
  1105.  
  1106.     Test results for a 100,000 times loop (same line):
  1107.  
  1108.         Old routines = 25.00 seconds  (100 %)
  1109.         New routines = 16.04 seconds  ( 64 %)
  1110.  
  1111.   ■ Minor speed  enhancements in the routine that  gets all DOWNLOAD.TXT entry
  1112.     line fields.
  1113.  
  1114.   ■ Revised the critical routines that generates strings filled with SPACES or
  1115.     BACKSPACES. Performance increased about 52%.
  1116.  
  1117.     Test results for a 2,000,000 times loop (always 16 characters):
  1118.  
  1119.         Old routines = 32.47 seconds  (100 %)
  1120.         New routines = 15.60 seconds  ( 48 %)
  1121.  
  1122.   ■ All  source code concerning  the process of  search commands was  revised,
  1123.     and,  in some  cases, totally  rewritten. Some  of them,  source code  was
  1124.     dramatically reduced, which means speed will have increased in those parts
  1125.     of the program. Source of all this procedures are now much more compact.
  1126.  
  1127.   ■ Revised the routine that searches the scan entries in a DOWNLOAD.TXT entry
  1128.     line, using fast Assembler code. Performance increased about 14%.
  1129.  
  1130.     Test results for a 1,000,000 times loop (always search for 3 characters):
  1131.  
  1132.         Old routines = 31.43 seconds  (100 %)
  1133.         New routines = 27.20 seconds  ( 86 %)
  1134.  
  1135.   ■ Revised  the  routine  that  concatenates  the  entry  line  string  to be
  1136.     outputted each time a search match. Performance increased about 33%.
  1137.  
  1138.     Test results for a 50,000 times loop (always same string):
  1139.  
  1140.         Old routines = 30.22 seconds  (100 %)
  1141.         New routines = 20.38 seconds  ( 67 %)
  1142.  
  1143.   ■ Several other speed enhancements have been made.
  1144.  
  1145.   ■ JAwho will now display the following message (in red on black):
  1146.  
  1147.       "Corrupted entry!"
  1148.  
  1149.     when  he founds  that a  DOWNLOAD.TXT entry  line is  invalid. Line  entry
  1150.     number will also be displayed.
  1151.  
  1152.     This do  not happens when  the user performs  a Raw search.  In this case,
  1153.     data is  not checked, because  it is not  necessary, and really  increases
  1154.     speed. Besides, Raw searches are not the major features of JAwho. But, why
  1155.     not include Raw searches, as ProWho (ProRaw... eheheh) does ?
  1156.  
  1157.   ■ Changed  the way [X]  eXpert command  works.  Now it works  exactly as PCB
  1158.     works. When you are in eXpert mode, and you enter [X] JAwho will force you
  1159.     press an [ENTER]. If  you are NOT in eXpert mode, then  no [ENTER] will be
  1160.     forced, because it returns immediately to the Menu command prompt.
  1161.  
  1162.   ■ The [M]ode (color/mode) is already finished and available.
  1163.  
  1164.   ■ JAwho now displays (and now in light_green_on_black color):
  1165.  
  1166.         "(10%) Entry #1,200..."
  1167.  
  1168.     instead of (was in light_gray_on_black color):
  1169.  
  1170.         "Entry #1,200..."
  1171.  
  1172.     The  percentage  means  the  percentage  of  bytes  already  reed from the
  1173.     DOWNLOAD.TXT file. I think this  feature is very interesting, because lets
  1174.     the user  know how much have  been concluded in each  search, and not only
  1175.     the line entry number of the file. In a text file such as DOWNLOAD.TXT is,
  1176.     it is impossible to know how many  lines a text file have, except when you
  1177.     reach the  EOF (End-Of-File) marker (which  means that the very  last byte
  1178.     has been reed).
  1179.  
  1180.     So, prior to  anything, I check the size  of the file, and then  I keep an
  1181.     updated account of the number of bytes reed from the file. It's simple.
  1182.  
  1183.     In  the previous  versions, JAwho   updates that  "Entry #1,200"  each 100
  1184.     lines. I have changed this. Now updates are displayed each 200 lines.
  1185.  
  1186.   ■ Completely  rewritten statistics! Added  many new and  fancy features! See
  1187.     for your self! You gonna get a hard-attack when you see then, eheheh!
  1188.  
  1189.     In Raw searches, this statistics are much less elaborated, because most of
  1190.     the data are not available.
  1191.  
  1192. ------------------------------------------------------------------------------
  1193. JAwho v0.06:  Feb 16, 1993
  1194. ------------------------------------------------------------------------------
  1195.  
  1196.   ■ Corrected   shared   violation  error   when  two  nodes   were  accessing
  1197.     DOWNLOAD.TXT file. Bug was reported by Mr. Mário Pozzetti.
  1198.  
  1199. ------------------------------------------------------------------------------
  1200. JAwho v0.05:  Feb 16, 1993
  1201. ------------------------------------------------------------------------------
  1202.  
  1203.   ■ Only  one  thing has  changed  in  this release.  JAwho will  always start
  1204.     operate in  non-expert mode, instead  of reading PCBoard  flag (and assume
  1205.     it).  Several users  experimented problems   with this.  They seem  to not
  1206.     understand that they  must type the [X] command in  order to get the menu.
  1207.     And new users to the door doesn't not know the JAwho commands, off course.
  1208.  
  1209.     Mr.Mário Pozzetti (SysOp of SkyShip  BBS) also suggested this. Many thanks
  1210.     to him.
  1211.  
  1212.   ■ I  am  looking for  someone to  help correcting  my english  in the future
  1213.     manual of JAwho...
  1214.  
  1215. ------------------------------------------------------------------------------
  1216. JAwho v0.04:  Feb 15, 1993
  1217. ------------------------------------------------------------------------------
  1218.  
  1219.   ■ Many changes have been introduced, since last beta version.
  1220.  
  1221.   ■ JAwho is now based on ProKit v3.4 library instead od RMDoor v3.0.
  1222.  
  1223.     This is a major improvement!!!
  1224.  
  1225.     Many thanks to Mr.Mário Pozzetti (SysOp  of SkyShip BBS) who tried to find
  1226.     some good Turbo  Pascal library to use in JAwho.  We discussed a lot about
  1227.     this subject.
  1228.  
  1229.   ■ JAW_TEST.BAT file
  1230.  
  1231.     The  JAW_TEST.BAT file  remains the  same. Use  this file  to locally test
  1232.     JAwho  from outside  PCBoard environment.  Off course,  as usual, you will
  1233.     need  to edit  the file  and  specify  the proper  directories, for  JAwho
  1234.     configuration file and PCBoard directory.
  1235.  
  1236.   ■ JAWHO. file
  1237.  
  1238.     This is  the file PCBoard  will copy to  DOOR.BAT when running  JAwho. You
  1239.     must edit this  file in order to proper specify  all directories passed as
  1240.     parameters to JAwho.
  1241.  
  1242.     In multi-node  PCBoards systems, there is  an easy way to  avoid having as
  1243.     many  files like  this (and  JAwho .EXE  file) as  nodes. Simply create an
  1244.     environment SET, such as this (for instance, for node #4):
  1245.  
  1246.         SET PCB_NODE=C:\PCB4
  1247.  
  1248.     Or, for node #3:
  1249.  
  1250.         SET PCB_NODE=C:\PCB3
  1251.  
  1252.     Create a SET  (always with the same name, this  is very important) in each
  1253.     computer, correctly specifying the  local directory. Then, supposing JAwho
  1254.     is located  in the server computer,  where you probably put  all your door
  1255.     programs (let us say C:\DOORS\JAWHO), change JAWHO. file as this:
  1256.  
  1257.         @echo off
  1258.         c:\doors\jawho\jawho.exe c:\doors\jawho\jawho.cfg %PCB_NODE%
  1259.  
  1260.     This will work fine, and you only need one JAWHO. for ALL nodes.
  1261.  
  1262.   ■ $DOOR.ERR file
  1263.  
  1264.     This is  the JAwho error  log file. The  filename have been  changed since
  1265.     last version  (was JAWHO.LOG). Still is  a text file, and  data written to
  1266.     this file, is almost the same.
  1267.  
  1268.   ■ JAWHO.REG file
  1269.  
  1270.     The registration file. Remains exactly the same.
  1271.  
  1272.   ■ JAWHO.CFG
  1273.  
  1274.     This is  the JAwho configuration file.  The file now has  a different name
  1275.     (was JAWHOCFG.CFG). Everything has changed. JAwho itself does not read (or
  1276.     check) this file. It is required by the ProKit library.
  1277.  
  1278.     As always, the name is it  not important, because filename can be changed,
  1279.     as long you specify the correct parameter each time you call JAwho.
  1280.  
  1281.     This  file has  only one  statement at  the first  line. It  can be either
  1282.     INTERRUPT or BIOS. Nothing more is necessary to configure. Everything else
  1283.     has been removed.
  1284.  
  1285.   ■ JAWHO_I (and JAWHO_I.TD) files
  1286.  
  1287.     The JAwho door search Instructions screen file. This is NEW.
  1288.  
  1289.     This file will  be displayed anytime a user runs  a search command (except
  1290.     if user  is in eXpert  mode). The purpose  of this file,  is give the user
  1291.     a quick  reference about the way  he/she can make the  search. So, this is
  1292.     not exactly a help file (help files are different things).
  1293.  
  1294.     This file is a PCBoard @Xcodes. You  should not use ANSI codes. There is a
  1295.     very good TSR program, called PCBX.EXE  that is perfect to capture TheDraw
  1296.     screens into @Xcodes files.
  1297.  
  1298.     Many thanks  to Mr.Pedro Pinheiro (SysOp  of Crazy Byte BBS),  who gave me
  1299.     some ideas about this and other features of JAwho, while paciently testing
  1300.     my door at The Image Bank BBS.
  1301.  
  1302.   ■ All other @Xcodes files
  1303.  
  1304.     Remains all  with the same purpose,  but they are not  anymore ANSI files,
  1305.     but @Xcodes files. I only changed the JAWHO_M Menu contents.
  1306.  
  1307.   ■ JAwho commands
  1308.  
  1309.     JAwho commands are now all working, except the [H], [US], [DS] and [AS].
  1310.  
  1311.     The "|" character used to separate each search item was substituted by the
  1312.     ";" character.
  1313.  
  1314.   ■ I enhanced the statistics data, displayed after each search. Take a look.
  1315.  
  1316.   ■ There are lots of other new things,  but most of them refers to the method
  1317.     of programming.  I think (but  I'm now really  sure) that this  version is
  1318.     slower than the last one. This, being  true, is because of ProKit. I think
  1319.     RMDoor was faster.
  1320.  
  1321. ------------------------------------------------------------------------------
  1322. JAwho v0.03:  Feb 10, 1993
  1323. ------------------------------------------------------------------------------
  1324.  
  1325.   ■ I  have  renamed the  included  file  J.BAT to  JAW_TEST.BAT. The  purpose
  1326.     remains the same: testing JAwho outside PCBoard environment.
  1327.  
  1328.   ■ Corrected about a dozen bugs, concerning I/O errors.
  1329.  
  1330.     JAwho was not  displaying, and not writing to the  LOG file, the I/O error
  1331.     meaning. Instead, he displayed "Not an I/O error.". This happened in about
  1332.     a dozen places in the source. I forgot to change a parameter passed to the
  1333.     Error LOG procedure...
  1334.  
  1335.   ■ Corrected bug when a user enter the [Q]uit option.
  1336.  
  1337.     JAwho displayed "Invalid entry. Please try again @FIRST@..."
  1338.  
  1339.   ■ Added a new program command line parameter. Now the complete syntax is:
  1340.  
  1341.         JAWHO cfg_file [local] [pcb_dir]
  1342.  
  1343.     The third one  is the new parameter. I added  this to simplify the program
  1344.     test, while running without being under PCBoard environment.
  1345.  
  1346.     The program will determine the  PCBoard directory (specific node or "home"
  1347.     directory - it doesn't matter) by the following possible sequence:
  1348.  
  1349.         a) Current directory
  1350.  
  1351.            This is be the best recommended  way, because it always reflect the
  1352.            right directory  (either a node  specific or "home"  directory - it
  1353.            doesn't matter).
  1354.  
  1355.         b) 2nd or 3rd Command line parameter.
  1356.  
  1357.            If  you  specify  a  2nd  parameter,  JAwho  will  get it. Then, he
  1358.            determines if it  is the "LOCAL" parameter or not.  If is not, then
  1359.            JAwho will  use this 2nd  parameter as the  PCBoard directory. This
  1360.            overwrites the current directory way.
  1361.  
  1362.            If  the 2nd  parameter is  "LOCAL" then  he finds  out if  you have
  1363.            specified a  3rd parameter. If you  have, then JAwho will  use this
  1364.            3rd parameter  as the PCBoard  directory. This also  overwrites the
  1365.            current directory way.
  1366.  
  1367.            Specifying the  PCBoard directory in  the command line,  it is only
  1368.            recommended for  testing JAwho outside  PCBoard environment. I  use
  1369.            this feature in the included JAW_TEST.BAT batch file, to test JAwho
  1370.            in this situation.
  1371.  
  1372.         c) PCB_DIR= Statement in the configuration file.
  1373.  
  1374.            If you specify this statement, JAwho will use it. It overwrites the
  1375.            a) and b) situations.
  1376.  
  1377.            You  should  not  use  this  statement.  JAwho should determine the
  1378.            PCBoard directory by getting the current directory.
  1379.  
  1380.   ■ During  execution,  the program  may write  to disk  one or  two temporary
  1381.     files, depending if you specify the "LOCAL" command line parameter or not.
  1382.     And because normally you don't specify this parameter, then two files will
  1383.     be written to disk.
  1384.  
  1385.     It  always  written  a  file  with  the  EXACT  name  specified as the 1st
  1386.     parameter. Using the  examples provided, this file is  named JAWHOCFG (not
  1387.     the JAWHOCFG.CFG). This file is written  in the directory you specify, and
  1388.     should be the JAwho directory. This  file is not required by JAwho itself,
  1389.     but,  witch is  rather stupid,  by the  RMDoor initialization routines. An
  1390.     attempt is made to delete this file  when exiting the program. If the file
  1391.     is not found, this has no consequences whatsoever (it will be deleted next
  1392.     time JAwho runs).
  1393.  
  1394.     A second  file is temporary written  to disk (except when  you specify the
  1395.     "LOCAL" command  line parameter). This  file is always  named PCBOARD.SYS,
  1396.     and is always  written in the directory where your  USERS file is located.
  1397.     As  in   the  previous  paragraph,   this  file  is   required  by  RMDoor
  1398.     initialization  routines, to  be located  in the  same directory where the
  1399.     USERS  file is.  This is  even more  stupid..., and  JAwho itself  doesn't
  1400.     required this thing to be made this  way, of course. An attempt is made to
  1401.     delete this file when exiting the program.  If the file is not found, this
  1402.     has no consequences whatsoever (it will be deleted next time JAwho runs).
  1403.  
  1404.     I  think (and  I'm almost  sure) that  both USERS  and PCBOARD.SYS are not
  1405.     changed by the  RMDoor routines. Tests I've made  reflects that both files
  1406.     remain un-touchable. Again, I don't think  this is a good approach, in the
  1407.     PCBOARD.SYS case,  because if a  user looses CARRIER  the PCBOARD.SYS file
  1408.     contents should be changed, in order to reflect that (that's what they say
  1409.     in  the PCBoard  documentation). I  will  try  to test  this lost  CARRIER
  1410.     situation  as soon  as possible.  I think  I can  change the file contents
  1411.     after RMDoor des-initializes, and just before halting the program.
  1412.  
  1413.   ■ I  have changed the  JAWHO_M menu file.  Looks very much  the same, except
  1414.     when in color mode, all commands I have finished programming are displayed
  1415.     in yellow. This is a good way for you to each commands you can run.
  1416.  
  1417.   ■ Changed two names in the configuration file. Not really important to speak
  1418.     about. Only kind of a cosmetic change.
  1419.  
  1420.   ■ I have finished the [RC] command.
  1421.  
  1422.     This command works very much like ProWho does the job, only better. First,
  1423.     you can specify up to 5 scan entries (will be explained in detail when you
  1424.     enter the command).  And second, it also displays the  line number when he
  1425.     finds a match scan. Looks nice these way, I think.
  1426.  
  1427.   ■ Now that finished  the first search command, I need to  know is the search
  1428.     speed is faster enough...
  1429.  
  1430.   ■ Corrected bug when SysOp wants to shell to DOS.
  1431.  
  1432.     This was not working, and it is  not really a bug, because I simply forgot
  1433.     to include a  Turbo Pascal compiler directory, necessary  for Turbo Pascal
  1434.     perform the shell function...
  1435.  
  1436.     Tests I  have made tell that  the program now requires  about 93 KBytes of
  1437.     memory to run.
  1438.  
  1439. ------------------------------------------------------------------------------
  1440. JAwho v0.02:  Feb 8, 1993
  1441. ------------------------------------------------------------------------------
  1442.  
  1443.   ■ Please read  again ALL  the  notes  in the  INCLUDED FILES  section.  Some
  1444.     important things were changed.
  1445.  
  1446.   ■ I think now  some of the last version problems have  been removed. You can
  1447.     now run JAwho in multi-node systems,  with no problem. But, the door still
  1448.     is in beta besting.
  1449.  
  1450. ------------------------------------------------------------------------------
  1451. JAwho v0.01:  Feb 6, 1993
  1452. ------------------------------------------------------------------------------
  1453.  
  1454.   ■ This is the first version of the JAwho door. A beta version.
  1455.  
  1456.   ■ The program as not been fully tested. Be aware of that! :)
  1457.  
  1458.   ■ Put  all files included in  the archive in the  same directory. JAwho does
  1459.     not  require to  be placed  in a  specific directory.  You may  choose any
  1460.     directory you want, as long as the configuration is ok.
  1461.  
  1462.   ■ RMDoor  toolkit  used for  handling all  communications procedures, is not
  1463.     registered.  So,  it  displays  a   message  saying  that  RMDoor  is  not
  1464.     registered.
  1465.  
  1466.     I will register this toolkit as soon as possible.
  1467.  
  1468.   ■ The only Main Menu commands working at this time are:
  1469.  
  1470.         [X]pert menus on/off
  1471.         [Q]uit
  1472.  
  1473. ------------------------------------------------------------------------------
  1474. [end-of-file]
  1475.